home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / unsit.lzh / UNSIT.DOC < prev    next >
Text File  |  1990-12-15  |  4KB  |  86 lines
  1. unsit - extract/list files in a Macintosh Stuffit archive file
  2.  
  3. For the Stuffit archive file listed,  extracts the files in the archive
  4. into separate files. This makes it possible, for example, to separate a
  5. large StuffIt file into component files for selective downloading,
  6. rather than downloading the larger archive file just to extract a
  7. single, small file.  It also allows the use of StuffIt to compress a
  8. group of files into a single, smaller archive that can be uploaded to a
  9. Unix system for storage, printing, etc.
  10.  
  11. In the normal mode, both the data and the resource forks of the
  12. component Macintosh files in the archive are extracted and stored in
  13. Unix files with the extension .dat and .rsr appended to the end of the
  14. Macintosh file name. In addition, a  .inf file will be created with the
  15. Finder information. These three file are compatible with the macput
  16. program for downloading to a Mac running Macterminal. If only the data
  17. or resource fork is extracted, no addition extension is appended to the
  18. Mac file name. Characters in the Mac file name that are illegal (or
  19. unwieldy, like spaces) are changed to underscores in the Unix file
  20. name.  The true Mac file name  is retained in the .inf file and is
  21. restored when the file is downloaded.
  22.  
  23. StuffIt version 1.5 has the ability to archive a group of files and
  24. folders in such a way that the hierarchical relationship of the files
  25. and folders is maintained. Unsit version 1.5 can unpack files archived
  26. in this manner and place them in corresponding subdirectories so as to
  27. maintain the hierarchy.  As an option, the hierarcy can be flattened
  28. out and all the files stored in the current directory.
  29.  
  30. The options are similar to those for macput and unpit.
  31.  
  32. -f 
  33. For StuffIt files containing a "Hierarchy Maintained Folder" entry,
  34. extract the files into a "flat" organization (all in the current
  35. directory) rather than maintaining the hierarchy by creating new
  36. directories, etc. Default is to maintain the hierarchical folder
  37. organization.
  38.  
  39. -l  (el, not a number 1) 
  40. List the files in the archive but do not
  41. extract them.  The name, size, type, and creator of each file is
  42. listed.
  43.  
  44. -m
  45. Assumes the input file in MacBinary format rather than macput/macget
  46. format and skips over the MacBinary header.
  47.  
  48. -r
  49. Extract resources forks only.
  50.  
  51. -d
  52. Extract data forks only.
  53.  
  54. -u 
  55. Extract data fork and change into a Unix text file. This only works
  56. if the file is really a text file.
  57.  
  58. -q
  59. Query user before extracting files and folders.  If a "n" answer is given for
  60. a folder, none of the files or folders in that folder will be extracted.
  61.  
  62. -v 
  63. Verbose option.  Causes  unsit to list name, size, type, and creator
  64. of each file extracted.
  65.  
  66. BUGS 
  67. ---- 
  68. Files that were compressed by StuffIt with the Lempel-Ziv method and
  69. are extracted with the  -u switch (text files) are not checked for a
  70. correct CRC value when  .I unsit uncompresses them.  This is because 
  71. unsit pipes the data through compress and tr to extract the file and
  72. never has a chance to do the CRC check.
  73.  
  74. The compress program has been observed to go into strange states when
  75. uncompressing a  damaged file.  Often it will get stuck writing out
  76. bogus data until the disk fills up.  Since  unsit sends data through 
  77. compress, the same problem could occur when extracting files from a
  78. damaged Stuffit archive.
  79.  
  80. For archives that have been compressed with the Lempel-Ziv method, the 
  81. compress  program must be present on the system and in the search path
  82. since  unsit  uses it for the uncompressing. Compress is available from
  83. the comp.sources.unix archives.
  84.  
  85. Allan G. Weber (weber%brand.usc.edu@oberon.usc.edu)
  86.